Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Application Messages

GXStartJob

QuickDraw GX sends the GXStartJob message when the spooling of a document is initiated. You can override the GXStartJob message to set initial values at the start
of printing a document. Your override of the GXStartJob message must match the following formal declaration:

OSErr MyStartJob (StringPtr docName, long pageCount);

docName

The document name.

pageCount

The number of pages in the document.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXStartJob message to initiate spooling when an application calls the GXStartJob function to start printing.

You need to override this message if you want to initialize information when an application begins printing a document. You can also override this message to determine when a document is being spooled.

The default implementation of GXStartJob begins the process of saving the document into a spool file. It sends spooling messages to accomplish this.

SPECIAL CONSIDERATIONS

You never send this message yourself.

You must forward the GXStartJob message to other message handlers so that they can override it. If your override fails, you need to call the GXCleanupStartJob function to notify other handlers of the failure. If another handler returns an error, you must undo anything that you've done and return the same error.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXCleanupStartJob function is described on page 5-36 in the chapter "Printing Functions for Message Overrides."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help